<HTML><HEAD><TITLE>suspensions(?Var, -SuspensionList)</TITLE>
</HEAD><BODY>[ <A HREF="index.html">Advanced Control and Suspensions</A> | <A HREF="../../index.html">Reference Manual</A> | <A HREF="../../fullindex.html">Alphabetic Index</A> ]
<H1>suspensions(?Var, -SuspensionList)</H1>
Retrieves a list of all suspensions attached to the variable Var.
<DL>
<DT><EM>Var</EM></DT>
<DD>Any term.
</DD>
<DT><EM>SuspensionList</EM></DT>
<DD>List or variable.
</DD>
</DL>
<H2>Description</H2>
    Retrieves all live suspensions attached to the variable Var, and
    returns them in a duplicate-free list SuspensionList.
<P>
    Note that this is a relatively expensive operation, involving collecting
    all suspensions lists from the variable's attributes via their respective
    suspensions-handlers, then removing duplicates and dead suspensions.

<H3>Modes and Determinism</H3><UL>
<LI>suspensions(?, -) is det
</UL>
<H2>Examples</H2>
<PRE>
[eclipse 2]: suspend:(X&gt;5), suspensions(X, S).
X = X
S = ['SUSP-_256-susp']
Delayed goals:
        suspend : (X &gt; 5)
yes.

[eclipse 3]: suspensions(X, S).
X = X
S = []
yes.

[eclipse 4]: suspensions(12, S).
S = []
yes.
</PRE>
<H2>See Also</H2>
<A HREF="../../kernel/suspensions/suspensions-1.html">suspensions / 1</A>, <A HREF="../../kernel/suspensions/subcall-2.html">subcall / 2</A>, <A HREF="../../kernel/suspensions/get_suspension_data-3.html">get_suspension_data / 3</A>
</BODY></HTML>
